Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGGetChannelSampleDescription

The SGGetChannelSampleDescription function allows you to retrieve a channel's sample description.

pascal ComponentResult SGGetChannelSampleDescription 
                                 (SGChannel c, Handle sampleDesc);

c

Identifies the channel for this operation. You provide your
connection identifier. You connect to a channel component by calling the SGNewChannel or SGNewChannelFromComponent function, described on page 5-29 and page 5-30, respectively.

sampleDesc

Specifies a handle that is to receive the sample description.

DESCRIPTION

The SGGetChannelSampleDescription function allows you to retrieve a channel's current sample description. You may call this function only when the channel is prepared to record or is actually recording.

The channel returns a sample description that is appropriate to the type of data being captured. For video channels, the channel component returns an Image Compression Manager image description structure; for sound channels, you receive a sound description structure, as defined by the Movie Toolbox.

RESULT CODE

cantDoThatInCurrentMode

-9402

Request invalid in current mode

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help